unload
Type
command
Summary
Removes a file that was placed in the local cache by the load command, or cancels a download or upload in progress.
Syntax
unload [URL] <cachedURL>
Description
Use the unload command to release memory used by a cached URL when you no longer need it.
If the cachedURL is still being downloaded with the load command, the unload command cancels the download.
The unload command can be used to cancel any non-blocking FTP or HTTP file transfer in progress, but it does not cancel file transfers that were initiated by using a URL container in an expression or by putting something into a URL.
The unload command removes the cachedURL from the URLStatus function. This includes URLs that have been uploaded with the libURLftpUpload command, as well as those that have been cached with the load command.
You can use a URL with the URL keyword even after it has been unloaded from the cache, but caching speeds up access to the URL.
Parameters
| Name | Type | Description |
|---|---|---|
cachedURL | Any URL in the cachedURLs or any URL whose transfer was started with the libURLftpUpload, libURLftpUploadFile, or libURLDownloadToFile command. |
Examples
unload URL "http://www.example.com"
unload URL (line 1 of the cachedURLs)
unload URL "ftp://ftp.example.org/newfiles/latest.txt"
Related
command: revUnloadSpeech, libURLftpUpload, libURLDownloadToFile, get, load
control structure: function
function: result, cachedURLs, URLStatus
glossary: non-blocking, upload, download, cache, container, expression, URL, command, keyword
Compatibility and Support
Introduced
LiveCode 1.0
OS
mac
windows
linux
web
Platforms
desktop
server